(comment last updated: 2024-01-22 18:40:05)

Yes, this page is a complex one.

The general rule about dictionaries is that:

• we don't mention the dictionary name because it is not visible to the user.
• on each page where a dictionary is used, a list of its fields must be listed.

We do sometimes make exceptions:

• for very long dictionaries used on several pages, we can have a specific entry (not the cases here)
• when we have long dictionaries used in one constructor and one getter, we sometimes describe them in the constructor and only link to the object description of it in the getter. There must be a link to it.
• we don't need to describe everything for each object occurrence on the page, but only once per page, usually in the Value or Return value sections or in the Parameters one.

The difficulty on this API is that some of these dictionaries are being phased out (non-standard or deprecated) but have not been removed from the implementation. This is a reason why this has not been cleaned before.